README.win32: Add note on using OpenGL on Windows
authorChun-wei Fan <fanchunwei@src.gnome.org>
Mon, 1 Aug 2022 04:32:53 +0000 (12:32 +0800)
committerChun-wei Fan <fanchunwei@src.gnome.org>
Tue, 2 Aug 2022 05:53:06 +0000 (13:53 +0800)
...when running on a system with nVidia graphics with Nahimic installed, since
a known issue within the graphics drivers and/or Nahimic can cause random
crashes and issues when OpenGL (G[t|d]kGLArea) is being used.

This will close issue #4113--sadly, this issue is an issue that is beyond our
reach to try fixing within GTK.

README.win32

index 704f6f3cafc8d6f4ec2e307638ca094d95b031ac..f208a49ed9819f9ae7f1a60fafec223ba85c79fd 100644 (file)
@@ -3,6 +3,22 @@ The Win32 backend in GTK+ is not as stable or correct as the X11 one.
 For prebuilt runtime and developer packages see\r
 http://ftp.gnome.org/pub/gnome/binaries/win32/\r
 \r
+Notes on using OpenGL (GtkGLArea/GdkGLArea) on Win32\r
+====================================================\r
+Note that on Windows, if one is running Nahimic 3 on a system with\r
+nVidia graphics, one needs to stop the "Nahimic service" or insert\r
+the GTK application into the Nahimic blacklist, as noted in\r
+https://www.nvidia.com/en-us/geforce/forums/game-ready-drivers/13/297952/nahimic-and-nvidia-drivers-conflict/2334568/\r
+if using programs that utilise GtkGLArea and/or GdkGLArea, or use\r
+GDK_GL=gles if you know that GLES support is enabled for the build.\r
+\r
+This is a known issue, as the above link indicates, and affects quite\r
+a number of applications--sadly, since this issue lies within the\r
+nVidia graphics driver and/or the Nahimic 3 code, we are not able\r
+to rememdy this on the GTK side; the best bet before trying the above\r
+workarounds is to try to update your graphics drivers and Nahimic\r
+installation.\r
+\r
 Building GTK+ on Win32\r
 ======================\r
 \r